# Regression Report: V10 → V11 & Why V9 Remains Best

> **报告日期:** 2026-07-10
> **分析范围:** V10 (76/100) → V11 (88/100)
> **基准对比:** V9 (92/100) 🏆

---

## 1. V10 Regression 根因分析

### 1.1 得分瀑布

| # | 维度 | V9 | V10 | V11 | 变化 (V10) |
|---|------|----|-----|-----|-----------|
| 1 | 开头3秒吸引力 | 8 | **7** | 8 | ↙ -1 |
| 2 | Claude Code 真实界面感 | 10 | 9 | 9 | ↙ -1 |
| 3 | **多 Agent 并行感** | 9 | **6** | **8** | **↘ -3** 💥 |
| 4 | 手机端可读性 | 9 | 8 | 8 | ↙ -1 |
| 5 | 动画真实感 | 9 | **7** | 8 | ↙ -2 |
| 6 | PPT 感消除 | 9 | 9 | 9 | 0 |
| 7 | FAIL→FIX→PASS 叙事完整性 | 10 | 9 | 9 | ↙ -1 |
| 8 | 信息节奏 | 9 | 8 | 9 | ↙ -1 |
| 9 | 短视频吸引力 | 9 | **7** | 8 | ↙ -2 |
| 10 | 总体发布可用性 | 10 | **6** | **8** | **↘ -4** 💥 |
| **总分** | | **92** | **76** | **88** | **↘ -16** |

### 1.2 核心缺陷

**缺陷 #1 — 硬编码 Agent 数量 (Bug)**
- 文件: `render_frames_v10.py:588`
- 症状: 画面显示 4 个 agents 在并行工作，底部却硬编码 "3/3 agents working"
- 严重性: **视觉逻辑矛盾 — 直接破坏可信度**
- 根因: V10 在 v9 基础上增加了 analyst agent (4 agents)，但状态显示未同步更新

**缺陷 #2 — 黑屏间隙**
- 症状: Hook 段落中间出现 1.0-1.5s 黑屏
- 影响: 开头节奏稀疏，削弱第一印象

**缺陷 #3 — 顶部元数据/底部标签回归**
- V9 已清除的制作痕迹在 V10 中重新出现或未被正确更新
- 版本标签从 v9 改为 v10 的过程中引入不一致

### 1.3 V10 教训

| 教训 | 严重性 |
|------|--------|
| 硬编码是零容忍 bug | 🔴 CRITICAL |
| 增加 agent 数量时必须同步所有引用点 | 🟡 HIGH |
| 视觉效果一致性比新增功能更重要 | 🟡 HIGH |
| V9 已完成 cleanup 不应被后续改动破坏 | 🟠 MEDIUM |

---

## 2. V11 修复内容

### 2.1 修复清单

| # | 问题 | 修复方式 | 效果 |
|---|------|---------|------|
| 1 | `render_frames_v10.py:588` "3/3 agents" | 改为 `len(agents)` 动态计算 | ✅ 数量一致 |
| 2 | `render_frames_v10.py:375` "allocating to 3 workers" | 改为动态 | ✅ |
| 3 | `compose_v10.py:51` "3 agents running" | → "4 agents running" | ✅ |
| 4 | agent_complete stagger 时间 | `i*0.08` → `i*0.05` | ✅ 节奏改善 |
| 5 | Hook 黑屏间隙 | 优化空白段 | ✅ 部分修复 |
| 6 | 底部 tiny text | 清理 | ✅ |

### 2.2 V11 得分恢复分析

```
V10: 76 (坑底)
  ↕ 修复 6 项缺陷
V11: 88 (+12 分, 恢复)
  ⚠ 但仍低于 V9 92 分 (-4)
```

V11 恢复了 V10 造成的损伤，但没有做出任何超越 V9 的改进。

---

## 3. 为什么 V11 仍不能替代 V9

### 3.1 分数对比

| 指标 | V9 (92) | V11 (88) | 差距 |
|------|---------|----------|------|
| 总分 | **92** | 88 | **-4** |
| 界面真实感 | **10** | 9 | -1 |
| 叙事完整性 | **10** | 9 | -1 |
| 发布可用性 | **10** | 8 | **-2** |
| 制作痕迹 | **全部清除** | 有 v10 残留 | - |

### 3.2 定性对比

**V9 是 "成品"**: 制作痕迹全部清除 → 可直接发布
**V11 是 "修复品"**: 只是把 V10 修到能用 → 但仍不如 V9 干净

**类比:**
- V9 = 精装交付
- V10 = 装修砸墙
- V11 = 把墙补上了但墙纸对不齐

### 3.3 关键判断

| 维度 | 判断 |
|------|------|
| V11 是否比 V9 更好？ | ❌ 88 < 92 |
| V11 是否可发布？ | ⚠️ 勉强可发但不如 V9 |
| 是否应基于 V11 继续优化？ | **❌ 禁止** |
| 后续应基于哪个版本？ | **✅ V9 分支** |

---

## 4. V12 启动策略 (如果继续)

```
❌ 不要从 V11 继续
❌ 不要从 V10 继续
✅ 必须从 V9 分支复制 V12

V9 (92) ─┬─ V10 (76, regression — 死路)
          │      └─ V11 (88, 修复但未超越)
          │
          └─ V12 (目标: 93+) ← 正确起点
```

### V12 建议方向

1. **开头 3s hook 增强**: 在进度条前加入 "4 agents · auto-fix" 标题卡或 FAIL 预告
2. **结尾卡片动画化**: PASS 页统计卡片 stagger 入场，消除静态感
3. **信息密度微调**: 部分段落可压缩，部分段落可展开
4. **Agent 数量统一**: 开头直接显示 4 agents (含 analyst)，避免数量不一致

### V12 禁止项

- ❌ 硬编码数值
- ❌ 引入黑屏/空白段
- ❌ 破坏 V9 已清除的制作痕迹
- ❌ 从 V10/V11 代码复制

---

## 5. 总结

| 项目 | 结论 |
|------|------|
| V10 为什么降到 76 | 硬编码 "3/3 agents" + 黑屏间隙 + 制作痕迹回归 |
| V11 修复了什么 | 6 项 bug 修复，得分从 76 恢复到 88 |
| 为什么 V11 不能替代 V9 | 88 < 92，V11 只是修复品不是升级品 |
| V9 的价值 | 迭代终点，质量天花板，制作痕迹全清除 |
| 后续策略 | **如果继续，从 V9 fork V12，不碰 V10/V11 代码** |

---

*"V10 告诉我们创新不能引入硬编码 bug。V11 告诉我们修复 bug 不等于超越前版。V9 仍然是王。"*